home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 January / Macworld (1998-01).dmg / Updaters / Peak™ 1.61 Update / Peak™ 1.61 (FAT) / Peak™ 1.61 (FAT).rsrc / TEXT_7420_Batch File Processor.txt < prev    next >
Text File  |  1997-10-24  |  7KB  |  88 lines

  1. Batch File Processor
  2.  
  3. Peak‚Äôs Batch File Processor is one of the most powerful, versatile, and useful additions to Peak 1.5.  With the Batch Processor, you can carry out any series of Peak processes (called a batch script) that is applied to even thousands of files.
  4.  
  5. Peak‚Äôs Batch File Processor is split into three areas:  Input, Process, and Save Changes.   Sequence a series of steps for Peak to execute in the ‚ÄúProcess‚Äù section, then set your output file settings in the ‚ÄúSave Changes‚Äù area.  Once Peak‚Äôs Batch File Processor is configured, you may turn the Batch File Processor on in the ‚ÄúInput‚Äù area
  6.  
  7. Once the Batch File Processor is configured and turned on, any files you drop onto the Peak application‚Äôs icon in the Finder will be batch processed according to your settings.  You can even drop folders or disks onto Peak‚Äôs icon and all of the supported contents will be batch processed.  Supported contents include all file formats that Peak can read, including AIFF, Sound Designer II, QuickTime, Redbook, System 7 Sound, .snd, .au, and .WAV files.
  8.  
  9. New audio documents created with the Batch File Processor will have the same file name as the original input audio document.  
  10.  
  11.  ** You must open an audio document and make a selection in the document before you can configure the Batch File Processor.  The audio document and selection you make will be used for any previewing of processes sequenced into your batch script.
  12.  
  13. Input Area
  14.  
  15. The Input Area allows you to enable or disable batch file processing.  Once the Batch File Processor is configured, you may turn it on with the ‚ÄúOn‚Äù button.  If you have finished batch processing and no longer need to batch process files, you can use the ‚ÄúOff‚Äù button to disable batch file processing.
  16.  
  17. Process Area
  18.  
  19. The Process Area shows two lists.  The list on the left, labeled ‚ÄúAvailable Processes:‚Äù allows you to select processes that will be used in your batch script.  Every process or plug-in available in Peak will appear in this list.  The list on the right is labeled ‚ÄúSelected Processes For Batch‚Äù and contains the Peak processes in the current batch script.
  20.  
  21. Double click on a process in the ‚ÄúAvailable Processes:‚Äù list to add it to the ‚ÄúSelected Processes for Batch‚Äù list.  Alternatively, click on a process in the ‚ÄúAvailable Processes‚Äù list and then click the ‚ÄúAdd >>‚Äú button.  
  22.  
  23. When you add process to the ‚ÄúAvailable Processes‚Äù list, you may be required to supply settings for the process.  The frontmost audio document and selection will be used for any previewing the process may support.   Peak‚Äôs batch processor allows you to use multiple instances of a single process, each with its own settings.
  24.  
  25.  
  26. ** If you are going to process both stereo and mono audio documents, open a stereo audio document and make a selection before configuring the batch processor.  This will allow the process to make decisions on how to process both mono and stereo input files using the Batch File Processor.
  27.  
  28. You may also specify while part of the file to apply the process to.  Once a process has been added to the ‚ÄúSelected Processes for Batch‚Äù list, you may use one of the buttons ‚ÄúEntire File,‚Äù ‚ÄúApply Just To First x Seconds,‚Äù or ‚ÄúApply Just To Last x Seconds‚Äù.  Use these buttons to configure how to apply the selected process to an audio document.  For instance, if you are using a ‚ÄúFade In‚Äù process and only wish to apply it to just the first three seconds of the audio document, click the ‚ÄúFade In‚Äù process from the ‚ÄúSelected Processes for Batch‚Äù list and then type ‚Äú3‚Äù into the ‚ÄúApply Just to First x Seconds‚Äù edit text field.  All processes are applied by default to ‚ÄúEntire File‚Äù unless you configure the process otherwise.
  29.  
  30. Save Changes Area
  31.  
  32. Use the Save Changes Area to configure how your audio documents will be stored after they have been saved using your batch script.  Click the ‚ÄúSet...‚Äù button to specify the output document format and settings.
  33.  
  34. After clicking ‚ÄúSet...‚Äù you will be asked to provide the output file format, bit depth, and compression options using the ‚ÄúSave As...‚Äù dialog described in Chapter 4.  Choose which folder to save the processed audio files into with the ‚ÄúSave As...‚Äù dialog.
  35.  
  36. You can create a text ‚ÄúLog File‚Äù during batch processing to keep track of which files have been processed.  This is useful for lengthy batch processing sessions where the possibility of a power failure or other circumstance could prevent the batch process from completing.  Click on the ‚ÄúLog File...‚Äù checkbox to specify that a log file for the batch process.  After turning the ‚ÄúLog File...‚Äù feature on, Peak will ask you to provide a destination for the log file.  The log file can be viewed using SimpleText or any application that can view text files.  The Batch File Processor will divert any error messages to the log file if it is enabled.  This is useful because any errors Peak encounters during batch file processing will not require user attention during processing.  However, Peak will issue a System Beep sound if an error occurs during Batch File Processing.  If this happens, check the log file for errors.
  37.  
  38. Save Script
  39.  
  40. Peak allows you to save your batch script into a settings file that can be recalled later.  This feature is useful if you frequently process files using a specific sequence of processes.  After configuring the Batch File Processor, click ‚ÄúSave Script...‚Äù to save your batch sequence into a Batch Script file.  You will be prompted for a saving location and name for the batch script.  The settings file holding your batch script will store the processes, each process‚Äô settings, the and output file format. 
  41.  
  42. Load Script
  43.  
  44. To recall a batch script settings file that was stored using the ‚ÄúSave Script‚Äù feature, described above, click this button.
  45.  
  46. Example: 
  47. To change a folder of files into AIFF IMA 4:1 files Normalized to 95% with a Log:
  48. 1. Open an AIFF file and make a selection.
  49. 2. Choose ‚ÄúBatch File Processor...‚Äù from the File Menu.
  50. 3. Double click the ‚ÄúNormalize‚Äùitem in the ‚ÄúAvailable Processes:‚Äù list.  Enter 95 into the following normalization settings dialog.
  51. 4.  Click ‚ÄúSet...‚Äù in the Save Changes Area of the Batch File Processor.  Choose ‚ÄúAIFF‚Äù from the ‚ÄúFile Format‚Äù pop-up menu.  Choose ‚ÄúIMA 4:1‚Äù from the ‚ÄúCompression‚Äù pop-up menu.
  52. 5.  Choose the folder to save the output files into.  Click ‚ÄúSave‚Äù.
  53. 6.  You will be back in the Batch File Processing Dialog.  Click ‚ÄúLog...‚Äù.  Choose the output folder to save the log file into.
  54. 7.  Click the ‚ÄúOn‚Äù button in the Input Area of the Batch File Processor.  The Batch File Processor is now turned on.
  55. 8.  Click ‚ÄúOK‚Äù to close the Batch File Processor dialog.
  56. 9.  Switch to the Finder and drag & drop a folder full of audio documents onto the Peak application‚Äôs icon.
  57. 10. Peak will process all of that were dropped onto it‚Äôs application icon from the Finder.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.